bluetooth: Add support for Channel Classification by weeTike · Pull Request #30825 · nrfconnect/sdk-nrf

weeTike · 2026-08-20T14:08:12Z

bluetooth: Add support for Channel Classification

This adds the Channel Classification feature which the central can use
to receive channel classification reports from the peripheral.
samples: bluetooth: Add Channel Classification sample

This sample demonstrates a usecase for channel classification.
The sample shows the central receiving channel classification reports
from the peripheral and applying them in a channel map update.

NordicBuilder · 2026-08-20T14:34:41Z

CI Information

^{To view the history of this post, click the 'edited' button above}
Build number: 6

Inputs:

Sources:

more details

Github labels

Enabled	Name	Description
	ci-disabled	Disable the ci execution
	ci-all-test	Run all of ci, no test spec filtering will be done
	ci-force-downstream	Force execution of downstream even if twister fails
	ci-run-twister	Force run twister
	ci-run-zephyr-twister	Force run zephyr twister
	ci-run-draft	Run CI on draft pull requests

List of changed files detected by CI (0)

Outputs:

Toolchain

Version:
Build docker image:

Test Spec & Results: ✅ Success; ❌ Failure; 🟠 Queued; 🟡 Progress; ◻️ Skipped; ⚠️ Quarantine

❌ Toolchain
❌ Build twister
❌ Integration tests

Note: This message is automatically posted and updated by the CI

This adds the Channel Classification feature which the central can use to receive channel classification reports from the peripheral. Signed-off-by: Timothy Keys <timothy.keys@nordicsemi.no>

This sample demonstrates a usecase for channel classification. The sample shows the central receiving channel classification reports from the peripheral and applying them in a channel map update. Signed-off-by: Timothy Keys <timothy.keys@nordicsemi.no>

github-actions · 2026-08-21T08:26:51Z

You can find the documentation preview for this PR here.

Preview links for modified nRF Connect SDK documents:

https://ncsbmdoc.z6.web.core.windows.net/ncs/PR-30825/nrf/releases_and_maturity/releases/release-notes-changelog.html
https://ncsbmdoc.z6.web.core.windows.net/ncs/PR-30825/nrf/samples/bluetooth/channel_classification/README.html

richabp

Initial review.

richabp · 2026-08-21T09:12:30Z

 * Added the :kconfig:option:`CONFIG_BT_HCI_SUPPORT_DEPRECATED_COMMANDS` Kconfig option to support deprecated HCI commands.
  The option is disabled by default, and enabling it may cause deprecation warnings or errors during compilation.
+* Added support for LE Channel Classification in the SoftDevice Controller through the :kconfig:option:`CONFIG_BT_CTLR_CHANNEL_CLASSIFICATION` Kconfig option.


Suggested change

* Added the :kconfig:option:`CONFIG_BT_HCI_SUPPORT_DEPRECATED_COMMANDS` Kconfig option to support deprecated HCI commands.

The option is disabled by default, and enabling it may cause deprecation warnings or errors during compilation.

* Added support for LE Channel Classification in the SoftDevice Controller through the :kconfig:option:`CONFIG_BT_CTLR_CHANNEL_CLASSIFICATION` Kconfig option.

* Added:

* The :kconfig:option:`CONFIG_BT_HCI_SUPPORT_DEPRECATED_COMMANDS` Kconfig option to support deprecated HCI commands.

The option is disabled by default, and enabling it may cause deprecation warnings or errors during compilation.

* Experimental support for the LE Channel Classification feature in the SoftDevice Controller using the :kconfig:option:`CONFIG_BT_CTLR_CHANNEL_CLASSIFICATION` Kconfig option.

richabp · 2026-08-21T09:17:30Z

  * Updated the minimum supported connection interval from 875 µs to 750 µs in the HID SCI configuration.
  * Enabled the Frame Space Update feature in the single peripheral HID SCI configuration.

+* Added the :ref:`ble_channel_classification` sample that demonstrates peripheral-initiated channel map updates and central reception of channel classification reports.


Please move this entry to line 319 as the first entry under Bluetooth samples.

richabp · 2026-08-21T09:35:38Z

+.. ncs-sample::
+   :title: Bluetooth: Channel Classification
+
+This sample demonstrates LE Channel Classification reporting between a central and a peripheral.


Suggested change

This sample demonstrates LE Channel Classification reporting between a central and a peripheral.

The Channel Classification sample demonstrates LE Channel Classification reporting between a central and a peripheral.

richabp · 2026-08-21T09:39:19Z

+
+When connected, the peripheral cycles through predefined host channel maps, changing every five seconds.
+
+The central enables channel classification reporting using :c:func:`hci_vs_sdc_channel_reporting_enable` and handles the received reports in a local HCI VS event callback.


Suggested change

The central enables channel classification reporting using :c:func:`hci_vs_sdc_channel_reporting_enable` and handles the received reports in a local HCI VS event callback.

The central enables channel classification reporting using the :c:func:`hci_vs_sdc_channel_reporting_enable` function and handles the received reports in a local HCI VS event callback.

richabp · 2026-08-21T09:42:53Z

+Overview
+********
+
+When connected, the peripheral cycles through predefined host channel maps, changing every five seconds.


Suggested change

When connected, the peripheral cycles through predefined host channel maps, changing every five seconds.

When connected, the peripheral cycles through predefined host channel maps, changing the active channel map every five seconds.

richabp · 2026-08-21T09:46:54Z

+#. In the other terminal emulator, type ``p`` to start the application in the peripheral role.
+#. Observe that the kits establish a connection.
+#. On the peripheral, observe a new channel map printed every five seconds.
+#. On the central, observe matching channel maps applied from the received classification reports.


Suggested change

#. On the central, observe matching channel maps applied from the received classification reports.

#. Observe matching channel maps applied on the central from the received classification reports.

richabp · 2026-08-21T09:52:57Z

+Sample output
+=============
+
+* Example peripheral output::


Suggested change

* Example peripheral output::

* The following is an example of the peripheral output:

richabp · 2026-08-21T09:53:28Z

+=============
+
+* Example peripheral output::
+


Please use .. code-block:: c directive.

richabp · 2026-08-21T09:54:24Z

+   I: Using channel map 2
+   I: Peripheral channel map df 7f ff fd 1f
+
+* Example central output::


Suggested change

* Example central output::

* The following is an example of the central output:

richabp · 2026-08-21T09:54:37Z

+   I: Peripheral channel map df 7f ff fd 1f
+
+* Example central output::
+


Suggested change

Please use .. code-block:: c directive.

NordicBuilder added doc-required PR must not be merged without tech writer approval. changelog labels Aug 20, 2026

weeTike force-pushed the channel_classification branch from 8c1e51a to b15b097 Compare August 20, 2026 14:28

weeTike force-pushed the channel_classification branch 3 times, most recently from 9429fd6 to b7306ad Compare August 20, 2026 16:21

weeTike added 2 commits August 21, 2026 08:53

bluetooth: Add support for Channel Classification

91c6f1e

This adds the Channel Classification feature which the central can use to receive channel classification reports from the peripheral. Signed-off-by: Timothy Keys <timothy.keys@nordicsemi.no>

weeTike force-pushed the channel_classification branch from b7306ad to cc509a1 Compare August 21, 2026 07:53

richabp requested changes Aug 21, 2026

View reviewed changes

Navigation Menu

Uh oh!

bluetooth: Add support for Channel Classification - #30825

bluetooth: Add support for Channel Classification#30825
weeTike wants to merge 2 commits into
nrfconnect:mainfrom
weeTike:channel_classification

weeTike commented Aug 20, 2026

Uh oh!

NordicBuilder commented Aug 20, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Aug 21, 2026

Uh oh!

richabp left a comment

Uh oh!

richabp Aug 21, 2026

Uh oh!

richabp Aug 21, 2026

Uh oh!

richabp Aug 21, 2026

Uh oh!

richabp Aug 21, 2026

Uh oh!

richabp Aug 21, 2026

Uh oh!

richabp Aug 21, 2026

Uh oh!

richabp Aug 21, 2026

Uh oh!

richabp Aug 21, 2026

Uh oh!

richabp Aug 21, 2026

Uh oh!

richabp Aug 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

	This sample demonstrates LE Channel Classification reporting between a central and a peripheral.
	The Channel Classification sample demonstrates LE Channel Classification reporting between a central and a peripheral.


		When connected, the peripheral cycles through predefined host channel maps, changing every five seconds.

		The central enables channel classification reporting using :c:func:`hci_vs_sdc_channel_reporting_enable` and handles the received reports in a local HCI VS event callback.

	#. On the central, observe matching channel maps applied from the received classification reports.
	#. Observe matching channel maps applied on the central from the received classification reports.

	* Example peripheral output::
	* The following is an example of the peripheral output:

	* Example central output::
	* The following is an example of the central output:

		I: Peripheral channel map df 7f ff fd 1f

		* Example central output::

Uh oh!

Conversation

weeTike commented Aug 20, 2026

Uh oh!

NordicBuilder commented Aug 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

CI Information

Inputs:

Sources:

Github labels

Outputs:

Toolchain

Test Spec & Results: ✅ Success; ❌ Failure; 🟠 Queued; 🟡 Progress; ◻️ Skipped; ⚠️ Quarantine

Uh oh!

github-actions Bot commented Aug 21, 2026

Uh oh!

richabp left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

NordicBuilder commented Aug 20, 2026 •

edited

Loading